home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 22 / Amiga Format AFCD22 (Jan 1998, Issue 106).iso / -seriously_amiga- / shareware / programming / other / gui4cli / g4c / fsearch / fsearch.readme < prev    next >
Text File  |  1997-11-17  |  3KB  |  92 lines
  1. Short    : Fast CLI command to search files (+gui)
  2. Uploader : dck@hol.gr (D. Keletsekis)
  3. Author   : dck@hol.gr (D. Keletsekis)
  4. Type     : util/cli
  5. Version  : 1.1
  6. Requires : WB 2.0+
  7.  
  8.  
  9. FSearch is a pure CLI command for Listing & Searching files.
  10.  
  11. Searching of files is fast and the template provided allows 
  12. you to accurately describe the types of files you are looking 
  13. for, thereby drastically reducing the scope of the search.
  14.  
  15. A great looking, resizable, multitasking GUI is also 
  16. provided (preview included). The gui is independent of the 
  17. command itself, so you can use it (or not) as needed.
  18. To run the GUI you need the Gui4Cli program which you can 
  19. download from Aminet at dev/gui/Gui4Cli.lha
  20.  
  21. Fsearch has the following template :
  22.  
  23. ROOT/A/M        Where to start searching from.
  24.                 May be multiple root sources - with wild-cards
  25.                 ex : FSearch ram: dh0:mydir#? all
  26.                 List all files in all dirs in ram: and all
  27.                 files in all dirs matching dh0:mydir#?
  28.  
  29.         This option must be given. 
  30.         All others are optional.        
  31.  
  32. PAT/K           (string) File pattern to match
  33.                 Only files meeting this pattern will be searched
  34.                 ex : FSearch ram: pat=#?.info all
  35.                 List all info files in ram: or it's sub-dirs
  36.  
  37. TXT/K           (string) Text to search for. 
  38.         By default the search is case-insensitive.
  39.         If this option is not specified FSearch will act
  40.         like "list".
  41.                 ex : FSearch ram: txt="my name" all
  42.  
  43. FROM/K          (date) Only search files FROM this date and up.
  44.         Dates must be written as dd-mm-yy.
  45.                 ex : FSearch ram: from=07-08-96
  46.  
  47. TO/K            (date) Only search files UP to this date
  48.  
  49. MIN/N/K         (number) Only search files more than MIN Kb.
  50.                 ex : FSearch ram: min=100 (look for files >= 100k)
  51.  
  52. MAX/N/K         (number) Only search files less than MAX Kb.
  53.  
  54. HEADER/K        (string) Only search files which have this header.
  55.                 The Header specification may contain wild cards.
  56.                 The first 100 bytes of the file will be loaded
  57.                 and checked against this Header.
  58.         ex : FSearch ram: header=FORM????ILBM#? all
  59.         will list all iff pictures in ram:
  60.  
  61. ALL/S           Recursively scan sub-directories
  62.  
  63. CS=CASESENSITIVE/S      
  64.         Make search case-sensitive
  65.  
  66. V=VERBOSE/S     Print Line number & text of lines found.
  67.                 The default is to just print the file name on the
  68.                 first occurance of the TXT you're looking for.
  69.                 With this option all the matches and their 
  70.                 context will be displayed. If the line length is 
  71.         over 80 chars it will be clipped.
  72.  
  73. NOBIN/S         Do not check binary files. Up to 100 bytes of the
  74.                 file will be loaded and file will be skipped if
  75.         this header contains any non-ascii characters.
  76.  
  77. HL=HIGHLIGHT/S  Highlight the search results
  78.  
  79. INFO/S          Print file size/date/time next to it's name
  80.         No file paths are printed if this option is on.
  81.  
  82. NOPATH/S        Print only the file name - not the full path.
  83.  
  84.  
  85. This program is FreeWare, but remains the Copyright of D.Keletsekis.
  86. No guarantees as to its performance or actions is made or implied.
  87. Use it at your own risk. 
  88.  
  89. D. Keletsekis
  90. September 1997
  91.  
  92.